Inventory Reporting & Management

Use Inventory Reporting & Management to create detailed inventory reports of devices, rooms, and sites.

Examples

Inventory - Provide a View of the devices associated to a specific Account (Tenant). If an Account (Tenant) Id is provided as an URL parameter, it will be shown if you have access to the requested account.

All Inventory - Provide a View of all devices associated to all accounts you have access to.

Device Details - Clicking into any device from inventory dives provides the information applicable to a device and made available through Poly Lens.

Supported APIs

Custom Device Tags

API	Description	Type	Required Arguments	Requires Poly Lens Premium
addDeviceTag	Attaches a new tag to a device and returns the list of all the tags for the device.	Mutation	tag, deviceId	No
removeDeviceTag	Removes the specified tag from a device and returns the list of all tags for the device.	Mutation	tag, deviceId	No

Inventory Reporting

API	Description	Type	Required Arguments	Requires Poly Lens Premium
catalogModels	Returns the hardware product information for the products in the product catalog.	Query	n/a	No
countDevices	Returns the total number of devices the requesting user has permission to view, across all tenants that the user can access.	Query	n/a	No
deviceAggregations	Grouping the devices based on their geographical location.	Query	n/a	No
deviceSearch	Searches for devices using query parameters. Supports pagination and finding results of more than 10K entries. Note: The pageSize should be limited to 5000 entries or less (default 10). Also, pageSize parameter of subsequent page calls must be identical to the first, or an error will be returned.	Query	n/a	No
hardwareModel	Hardware Model level details for an item in the product catalog.	Query	hardwareModelId	No

Notification Center

API	Description	Type	Required Arguments
ncAddRecipient	Adds a recipient who will receive notifications.	Mutation	tenantId, input
ncConfirmEmail	Confirms recipient's email address.	Mutation	inviteId
ncCreateServiceNowWebhook	Creates a new webhook in Poly Lens for ServiceNow.	Mutation	tenantId, input
ncCreateTeamsWebhookForTenant	Creates a new webhook in Poly Lens for Microsoft Teams.	Mutation	tenantId
ncDeleteServiceNowWebhook	Deletes a ServiceNow webhook.	Mutation	tenantId, webhookId
ncDeleteTeamsWebhook	Deletes a Microsoft Teams webhook.	Mutation	tenantId, webhookId
ncDisableAction	Disables notifications for an action.	Mutation	tenantId, input
ncDisableServiceNowWebhook	Disables a ServiceNow webhook.	Mutation	tenantId, webhookId
ncDisableTeamsWebhook	Disables a Microsoft Teams webhook.	Mutation	tenantId, webhookId
ncDisableTenant	Disables email notifications for an Account (Tenant).	Mutation	tenantId
ncDisableUser	Disables email notifications for users.	Mutation	tenantId, userId
ncEnableAction	Enables notifications for an action.	Mutation	tenantId, input
ncEnableServiceNowWebhook	Enables a ServiceNow webhook to start sending notifications to ServiceNow.	Mutation	tenantId, webhookId
ncEnableTeamsWebhook	Enables a Microsoft Teams webhook to start sending notifications to Microsoft Teams.	Mutation	tenantId, webhookId
ncEnableTenant	Enables email notifications for an Account (Tenant).	Mutation	tenantId
ncEnableUser	Enables email notifications for users.	Mutation	tenantId, userId
ncPoly	Returns details of all Poly notification configurations.	Query	tenantId
ncRemoveRecipient	Removes a recipient.	Mutation	tenantId, input
ncReplaceRecipient	Replaces a recipient.	Mutation	tenantId, input
ncServiceNow	Returns details of all configured ServiceNow webhooks.	Query	tenantId
ncSetFrequency	Sets notification frequency for an action.	Mutation	tenantId, input
ncTeams	Returns details of all configured Microsoft Teams webhooks.	Query	tenantId
ncTestServiceNowWebhook	Tests a ServiceNow webhook.	Mutation	tenantId, input
ncTestServiceNowWebhookWithParams	Tests a ServiceNow webhook with parameters.	Mutation	tenantId, input
ncTestTeamsWebhook	Tests a Microsoft Teams webhook.	Mutation	tenantId, input
ncUnsubscribe	Unsubscribes a recipient.	Mutation	inviteId
ncUpdateServiceNowActionConfiguration	Updates action configuration of a ServiceNow webhook.	Mutation	tenantId, input
ncUpdateServiceNowWebhook	Updates a ServiceNow webhook.	Mutation	tenantId, webhookId, input
ncUpdateTeamsWebhook	Updates a Microsoft Teams webhook.	Mutation	tenantId, webhookId, input
ncUpdateWebhookActionConfiguration	Updates action configuration of a Microsoft Teams webhook.	Mutation	tenantId, input
notificationCenter	Enables Account (Tenant) admin or device manager to enable and configure notifications for events that occur in Poly Lens.	Query	tenantId

Room & Site Management

API	Description	Type	Required Arguments	Requires Poly Lens Premium
deleteRooms	Deletes an existing room or sets of rooms.	Mutation	tenantId, ids	No
deleteSites	Deletes an existing site or set of sites.	Mutation	tenantId, ids	No
room	Gets detailed data for a specified room.	Query	roomId	No
roomData	Retrieves room data for a specified Account (Tenant).	Query	tenantId	No
site	Gets the geographical location of the device.	Query	siteId	No
siteData	Retrieves site data for a specified Account (Tenant).	Query	tenantId	No
switchSite	Switches a room to another site.	Mutation	tenantId, siteId, roomId	No
upsertRoom	Creates a new room or updates an existing room if applicable.	Mutation	tenantId, siteId	No
upsertSite	Creates a new site or updates an existing site if applicable.	Mutation	tenantId, name	No

Subnet Management

API	Description	Type	Required Arguments	Requires Poly Lens Premium
createSubnetRule	Creates a new subnet rule.	Mutation	siteId, publicCidr	No
deleteSubnetRule	Deletes an existing subnet rule.	Mutation	ruleId	No
getSubnetRules	Get subnet rules for a given site.	Query	siteId	No
getSubnetRuleValidity	Check if site subnet rules are valid.	Query	tenantId, siteId, publicCidr	No
updateSubnetRule	Updates an existing subnet rule.	Mutation	publicCidr, ruleId	No